home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / pcbvpack.zip / PCBVPACK.DOC < prev    next >
Text File  |  1991-12-08  |  10KB  |  225 lines
  1.                                         
  2.                                   PCBVPack v1.0
  3.                          Copyright (c) 1991 By Rick Kuban
  4.  
  5.  
  6.           INTRODUCTION:
  7.           -------------
  8.                PCBVPack is a utility program written to automate and
  9.           speed a PCBoard 14.5+ sysop's maintainance of the verified
  10.           numbers list created by the excellent call-back verifier door
  11.           PCBVerify v3.10 written by Curtis Kowalski. It provides the
  12.           same function as the PURGE utility provided with PCBVerify,
  13.           but also operates in a faster and more flexible mode which
  14.           uses a file of deleted users created by the PCBoard utility
  15.           PCBPACK.EXE. It is designed to be run either as a stand-alone
  16.           utility, or in a nightly event.
  17.  
  18.  
  19.           STANDARD "DEMO" LICENSE:
  20.           ------------------------
  21.               PCBVPack is a Shareware program, and uploading of the code
  22.           to various bulletin boards and Shareware libraries is encouraged.
  23.           Several limitations must be implied, however:
  24.  
  25.           1)  Under no circumstances should the code be modified or dis-
  26.           tributed in any other form than what it was originally supplied
  27.           by the author. The exception is that PCBVPack may be compressed
  28.           using techniques other than ZIP, but the de-compressed form of
  29.           PCBVPack must remain intact. No files may be added to or removed
  30.           from the archive contents.
  31.  
  32.           Files included in the original archive are:
  33.  
  34.                    PCBVPack.exe - the executable program file
  35.                    PCBVPack.cfg - sample configuration file
  36.                    PCBVPack.doc - this documentation file
  37.                    PCBVPack.bat - sample batch file
  38.                    PCBVPack.reg - registration form
  39.                    FILE_ID.DIZ  - description file
  40.  
  41.           2)  PCBVPack may not be redistributed in any manner other than
  42.           electronic file transfer unless cleared with the author beforehand.
  43.           No money may be received for PCBVPack except to cover for telecom-
  44.           munications/service charges, and in such a case the cost may not
  45.           exceed $5.00 in US funds.
  46.  
  47.           3)  PCBVPack may be run for a period of time adequate to allow
  48.           for full testing of the software. If, after running the code for
  49.           one month, you decide not to purchase the registration license,
  50.           you must forfeit this license and remove PCBVPack from operation
  51.           on your system(s). You may keep a copy online for distribution
  52.           purposes only.
  53.  
  54.            4)  PCBVPack may not be hacked or modified in ANY manner.
  55.  
  56.  
  57.           REGISTRATION LICENSE:
  58.           ---------------------
  59.           1)   Once purchasing the registration license, the license is
  60.           extended for life. All future releases of PCBVPack will be made
  61.           available, for no additional charge.
  62.  
  63.           2)   The registration license is non-refundable and non-transfer-
  64.           able without prior consent of the author. The registration license
  65.           permits the licensee to operate PCBVPack on one (1) system only.
  66.           The definition of "system" will be construed to include a multiple
  67.           node network at the same physical location, operating under the
  68.           same bbs name.
  69.  
  70.           3)   The registration fee for PCBVPack is $5.00 in US funds.
  71.  
  72.           4)   Product support for PCBVPack will be provided to registered
  73.           users thru Technoid's Toybox BBS, (214) 226-6017. The registration
  74.           number mailed to each user will be requested at that time.
  75.  
  76.           DISCLAIMER:
  77.           -----------
  78.                Although the program has been tested, and is currently in
  79.           use on the authors bbs, the author assumes no responsibility nor
  80.           liability for any data loss, incurred costs, equipment or other
  81.           damage as a result of the use of PCBVPack. The user assumes all
  82.           risk for damages incurred from the use of this product.
  83.  
  84.  
  85.           CONFIGURING PCBVERIFY:
  86.           ----------------------
  87.                PCBVPack includes a configuration mode to aid in properly
  88.           creating the required configuration file, PCBVPACK.CFG. Simply run
  89.           PCBVPack with the command line switch "C" (case insensitive) as
  90.           shown in the example below, to enable the configuration mode.
  91.  
  92.           PCBVPack is designed to be run from the current, or default direc-
  93.           tory. First, change to the directory where PCBVPack is located.
  94.           From DOS, enter the following command:
  95.  
  96.           C:\PCBVPACK> PCBVPack C <enter>
  97.  
  98.           This will start PCBVPack in the configuration mode which will prompt
  99.           you for the drive and path information it requires to operate. Note
  100.           that although PCBVPack does read from the PCBoard USERS file and the
  101.           PCBVerify PCBVVER file, depending on mode, PCBVPack does *NOT* write
  102.           to or modify ANY files other than it's own.
  103.  
  104.  
  105.           PCBVPack CONFIGURATION FILE:
  106.           ----------------------------
  107.           Line Description
  108.           ---- --------------------------------------------------------------
  109.            1   Fully qualified filename of PCBVerify's verified numbers file.
  110.                Example: C:\PCBV310\PCBVVER
  111.  
  112.            2   Fully qualified filename of the file of deleted users created
  113.                by PCBoard's PCBPACK.EXE utility using the /CAP: switch.
  114.                Example: C:\PCB\MAIN\USERS.DEL
  115.  
  116.            3   Fully qualified filename of the packed verified numbers file
  117.                created by PCBVPack.
  118.                Example: C:\PCBV310\PCBVVER.PAK
  119.  
  120.            4   Fully qualified filename of the PCBoard USERS file.
  121.                Example: C:\PCB\MAIN\USERS
  122.  
  123.  
  124.           OPERATING PCBVPACK:
  125.           -------------------
  126.           PCBVPack relies on a file created by PCBoard's utility called
  127.           PCBPACK.EXE. By creatively using the options allowed by PCBPACK.EXE,
  128.           a sysop can pack his user file and create a file consisting of users
  129.           who are being deleted from the system for any of many criteria. While
  130.           the detailed use and operation of this utility will not be discussed
  131.           here, I urge you to study, understand, and use PCBPACK.EXE regularly
  132.           to keep your users file in good shape.
  133.                                            
  134.           To call up PCBVPack in the fast mode, simply change to the directory
  135.           where PCBVPack is located, and enter the command as in the
  136.           sample below:
  137.  
  138.           C:\PCBVPACK> PCBVPack <enter>
  139.  
  140.           This will run PCBVPack in the fastest mode, which compares each
  141.           record in the PCBVVER file against the names in the deleted users
  142.           file. As the deleted users file is much smaller than the users file,
  143.           the packing process is very fast. If a match is found, the record is
  144.           not included in the new PCBVVER.PAK file.
  145.  
  146.           You should delete or rename the deleted users file after each use of
  147.           the PCBVPack utility. PCBPACK will append to the list each time it is
  148.           run. By deleting the file, you will prevent it from searching for the
  149.           same records over again the next time PCBVPack is run. This will
  150.           greatly reduce the time required to pack the PCBVVER file if you run
  151.           PCBVPack in your nightly event.
  152.  
  153.  
  154.           "U" Command Line Switch:
  155.  
  156.           Calling PCBVPack with the "U" switch should be done the first time
  157.           you run it against the PCBVVER file. This will cause PCBVPack to
  158.           compare the verified numbers list against the PCBoard USERS file
  159.           instead of the deleted users list. This mode is the same as the
  160.           PURGE utility provided with PCBVerify.
  161.  
  162.           Although this mode does take a considerable amount more time to run,
  163.           it will completely clean up the verified numbers file, deleting any
  164.           records that may not otherwise be found because:
  165.  
  166.           1) the user was previously deleted and not manually removed from
  167.              PCBVVER at the time;
  168.           2) the PCBVVER file has been tampered with using a text editor; or
  169.           3) any other of several reasons that may have contaminated the
  170.              PCBVVER file preventing a 100% match using the faster deleted
  171.              users file mode.
  172.  
  173.  
  174.           PCBVPack BATCH FILE:
  175.           --------------------
  176.           When calling up PCBPack, you may want to include several other
  177.           lines in addition to actual command to bring up PCBVPack. Consider
  178.           the following example:
  179.  
  180.           REM - Copy PCBVVER file to backup
  181.           COPY C:\PCBV310\PCBVVER C:\PCBV310\PCBVVER.BAK
  182.           REM - Run PCBVPack in fast mode
  183.           CD \PCBVPACK
  184.           PCBVPACK
  185.           REM - Copy PCBVVER.PAK to PCBVVER
  186.           COPY C:\PCBV310\PCBVVER.PAK C:\PCBV310\PCBVVER
  187.           REM - Delete  USERS.DEL & PCBVVER.PAK files
  188.           DEL C:\PCB\MAIN\USERS.DEL
  189.           DEL C:\PCBV310\PCBVVER.PAK
  190.  
  191.           ACKNOWLEDGEMENTS:
  192.           -----------------
  193.           PCBVerify; Curtis Kowalski
  194.           PCBoard, PCBPack; Clark Development Co., Inc
  195.  
  196. ------------------------------------------------------------------------------
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.